home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
ipaste.z
/
ipaste
Wrap
Text File
|
1998-10-20
|
7KB
|
133 lines
IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG)))) IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG))))
NNNNAAAAMMMMEEEE
ipaste - display an image
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
iiiippppaaaasssstttteeee [[[[----ffff]]]] [[[[----nnnn]]]] [[[[----ssssxxxx]]]] [[[[----oooo xxxxoooorrrrgggg yyyyoooorrrrgggg]]]] iiiimmmmggggffffiiiilllleeee
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_i_p_a_s_t_e is a utility that displays images stored using the image library
"libimage.a". _i_p_a_s_t_e reads pixel values, image dimensions and other
relevant data from the file _i_m_g_f_i_l_e via calls to the image library.
_i_p_a_s_t_e then displays the image in a window. On machines with few bit
planes, _i_p_a_s_t_e dithers the image.
The ----ffff option causes _i_p_a_s_t_e to run in the foreground. Normally, _i_p_a_s_t_e
forks off a background process to display the image while the foreground
process exits back to the command line. With this option the image is
displayed by the foreground process.
The ----nnnn option pastes the image without any window manager border. When
the image is viewed in this way, access to the window frame and its
buttons is disabled as the frame itself is not visible. However the X
window menu can still be popped up under 4Dwm by pressing the left Ctrl-
Shift keys simultaneously and then RIGHTMOUSE when the cursor is on top
of the image. The Minimize/Stow and Quit menu items give the same
results as the control buttons on the visible window frame. Moving the
image around can still be accomplished via the Move menu item, or by
pressing down the left Ctrl-Shift keys simultaneously, then pressing
MIDDLEMOUSE, and then moving the mouse.
The ----ssssxxxx option pastes the image with a white border or frame surrounding
it in the style of a Polaroid SX (TM) photograph. This option, like ----nnnn,
disables the window manager border.
The ----oooo xxxxoooorrrrgggg yyyyoooorrrrgggg option automatically pastes the image at a position on
the screen (absolute screen coordinates) that has as its origin (xorg,
yorg).
Pressing the EEEEsssscccc key on the keyboard will automatically quit out of
_i_p_a_s_t_e now. This is a nice short-cut when the image you are viewing is
borderless (i.e. has been pasted up using the ----nnnn option). However, due
the way the Xserver works with auto-repeat keys on the keyboard (like
Esc), _i_f you hold down the Escape key too long, and your current _i_p_a_s_t_e
window has another _i_p_a_s_t_e window underneath it, you will now find the
second _i_p_a_s_t_e window will also exit. Be careful when you use the "Esc"
key shortcut.
In the world of X, the easiest way to get access to the 4Dwm window
manager menu while over an _i_p_a_s_t_e window (or any GL client)--so you can
quit out of _i_p_a_s_t_e in this fashion--is to press either "Alt" key and then
press RIGHTMOUSE. This is the easiest way to stow, or iconize the image
and the safest way to quite out of a _i_p_a_s_t_e'd borderless window.
PPPPaaaaggggeeee 1111
IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG)))) IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG))))
The four arrow keys (LEFTARROWKEY, DOWNARROWKEY, RIGHTARROWKEY,
UPARROWKEY) can now be used to scoot the _i_p_a_s_t_e window to the left, down,
right, or up as long as the cursor is on top of the _i_p_a_s_t_e window when
you press one of these keys.
Caution: _i_p_a_s_t_e will NOT work with image files made using the old gl
program _d_i_t_h_e_r. For these dithered types of images (8 bits deep) you
will need to first use _f_r_o_m_d_i to convert them from dithered into RGB
format, and then can use _i_p_a_s_t_e to display them. _f_r_o_m_d_i._c lives in
/_u_s_r/_p_e_o_p_l_e/_4_D_g_i_f_t_s/_i_r_i_s_t_o_o_l_s/_i_m_g_t_o_o_l_s, and the executable is in the
moregltools subsystem on the EOE2 software product.
NNNNOOOOTTTTEEEESSSS
On machines having less than 24 bits available for RGB display, the
displayed image may appeared to have lost some quality. This occurs when
the image that was saved was in colormap mode. The pixel color index is
expanded into the full RGB information. When redisplayed, the RGB
information is dithered on these machines to approximate the original
image.
Under 4Dwm there is a constraint on the minimum width a window can have.
This affects users of ipaste(1G) who try to view image files which have
an xsize of less than 75 pixels. Quoting from the "OSF/Motif
Programmer's Guide", Version 1.1, Section 11.4.2.3, The Title Bar:
The title bar, which may include a title area, window menu button, and
minimize and maximize buttons, is constrained so that all components in
the title bar are always visible. This necessitates a minimum frame size
and, by extension, a minimum size for your application's window. The
size of the components in the title bar depends upon the size of the font
you choose for the title area text.
As a user shrinks your client window horizontally, space is removed from
the title area first. As the window is resized smaller, title text is
clipped from the right. The absolute minimum size of the title bar is
equal to the size of the buttons in the title bar, plus a title area
equivalent to the width of one title bar button.
The standard minimum-width window size in 4Dwm is 100 pixels. This is
based on the fact that SGI's buttons (which live in the area of the title
bar) are 25 pixels wide. The min size is calculated to be "buttonSize *
4" (assuming the buttons are of uniform size). Since _i_p_a_s_t_e has no
"maximize" button, the min size is "buttonSize * 3".
PPPPaaaaggggeeee 2222